home *** CD-ROM | disk | FTP | other *** search
/ Meeting Pearls 1 / Meeting Pearls Vol 1 (1994).iso / installed_progs / dev / fsystem-1.2 / fsystem.doc < prev    next >
Encoding:
Text File  |  1994-05-22  |  2.9 KB  |  98 lines
  1.                                   FSystem 1.2
  2.  
  3.                     A file handling module for Amiga-Oberon
  4.  
  5.                      Copyright © 1991-1994 by Lars Düning
  6.                              All rights reserved
  7.                    Permission granted for non-commercial use.
  8.  
  9.  
  10.  Introduction
  11.  ------------
  12.  
  13. 'FSystem' easens the dealing with files by providing function calls suiting
  14. to Oberon needs. Additionally buffered file io is implemented, speeding
  15. up operations (faster than 'FileSystem').
  16.  
  17. Included are the modules 'fio', 'fRealIO' and 'fLRealIO' offering an
  18. 'io'-type interface to make simple io in and from files.
  19.  
  20. 'FSystem' was initially developed to provide the 'FileSystem' of Amiga-
  21. Oberon 1.17.1 with read-write-access to files. Therefore the 'FSystem.File'
  22. structure is (still) source level compatible to 'FileSystem.File'.
  23. The speedup achieved by buffered IO then separated the development of
  24. 'FSystem' from 'FileSystem'.
  25.  
  26.  
  27.  Package
  28.  -------
  29.  
  30. The complete 'FSystem' archive contains these files:
  31.  
  32.   FSystem.mod   : the source of 'FSystem'
  33.   FSystem.txt   : the 'definition module' of FSystem
  34.   fio.mod       : the source of 'fio'
  35.   fRealIO.mod   : the source of 'fRealIO'
  36.   fLRealIO.mod  : the source of 'fLRealIO'
  37.   fio.txt       : the 'definition module' of fio, fRealIO and fLRealIO.
  38.   fioTest.mod   : a simple test program
  39.   FSystem.doc   : this documentation (english)
  40.   FSystem.dok   : this documentation (german)
  41.   sym/          : compiled symbol files
  42.   obj/          ; compiled object files
  43.  
  44. The files should, but needn't be equipped with icons (I don't really use
  45. workbench).
  46.  
  47. Developed and tested was 'FSystem' under Amiga-Oberon 3.10.
  48.  
  49.  
  50.  Installation & Usage
  51.  --------------------
  52.  
  53. Copy the sym/- and obj/-files into your Oberon path (or compile them
  54. yourself :-).
  55.  
  56.  
  57.  Bugs
  58.  ----
  59.  
  60. Since OS 2.0 buffered files are supported on OS level. 'FSystem' does not
  61.   make use of them yet.
  62.  
  63. Multiple assigns are not recognized.
  64.  
  65.  
  66.  Disclaimer
  67.  ----------
  68.  
  69. It runs on my machine - everything else is beyond my sphere of influence.
  70.  
  71. The module including ideas, algorithms and files is freeware: meant for
  72. the benefit of many, but not for someone making profit (money or glory)
  73. on my expenses. Infringement is a call for trouble.
  74.  
  75. Permission granted for non-commercial use, distribution, replication and
  76. development, as long as the 'meaning' remains the same, every change is
  77. clearly documented, and all files are included in the package
  78.  
  79. Permission granted for commercial distribution and replication as part
  80. of libraries and collections as long as the package is just 'one among many'.
  81.  
  82.  
  83.  Participants
  84.  ------------
  85.  
  86. Lars Düning; Am Wendenwehr 25; D-38114 Braunschweig; Germany
  87.   duening@ibr.cs.tu-bs.de
  88.  
  89. Fridtjof Siebert wrote in 1991 the runtime library modules from which FSystem
  90.   then evolved.
  91.  
  92.  
  93.  Basic principle
  94.  ---------------
  95.  
  96. "Klingon orders drink, Klingon gets drink, Klingon drinks."
  97.   -- Todd Alan Bobenrieth
  98.